home *** CD-ROM | disk | FTP | other *** search
/ Euroscene 2 / Euroscene 2.iso / USEFUL / libs / FileSys / XFH / README < prev    next >
Encoding:
Text File  |  1995-11-01  |  7.2 KB  |  161 lines
  1.  
  2.  
  3.                   Xpk File System Handler v1.12
  4.  
  5.                       By Kristian Nielsen
  6.  
  7.  
  8. This package may be distributed freely for non-commercial purposes along
  9. with Xpk or on its own, provided that all files and subdirectories are
  10. left intact. However, all rights remain with the author. And as usual,
  11. the author will in no way be held responsible for any damage, directly,
  12. implicit or otherwise, resulting from the use of this program. After
  13. all, you get this program for free; use it or not as you like, and at
  14. your own risk. 
  15.  
  16. This is version 1.12 of the XFH handler, distributed as part of the Xpk
  17. package. XFH is a file system handler like Ram: with the purpose of
  18. making the use of the Xpk compression libraries completely transparent
  19. for everyday use. Specifically, XFH can be set up to mirror a directory
  20. (or a whole disk) so that files can be accessed as normal through XFH:
  21. with the difference that any files that are compressed with Xpk (or
  22. PowerPacker) will be uncompressed fully automatic. Optionally, XFH can
  23. also be instructed to automatically compress files as they are written
  24. using any compression method that Xpk supports. So one use could be to
  25. finally have full access to your powerpacked 'Manuals:' directory and
  26. saving yourself the trouble to pull out powerpacker every time you want
  27. to add another file to the directory. Another more extreme usage would
  28. be to keep a whole partition compressed to save HD space. Whatever way
  29. XFH is used, you are free to mix compressed and 'normal' files; XFH will
  30. ensure that all files will appear as normal to application programs.
  31.  
  32. By doing this in the framework of a true DOS device handler, a very
  33. flexible and completely system- friendly solution is possible, avoiding
  34. any nasty 'patches' that has been the basis of earlier programs like
  35. PPPatch, though the current version of XFH may seem somewhat less
  36. efficient than these patches.  V1.12 works with Kickstart 1.2/1.3,
  37. though I would strongly recommend using it with 2.0.  Later versions are
  38. likely to be 2.0-only. 
  39.  
  40. Since this is an early release of the Xpk/XFH combination, a word of 
  41. warning is in order. First of all, please read the doc file ('XFH.doc', 
  42. which should be supplied along with this file) before using the XFH on any 
  43. large scale. It tries to anticipate some of the problems that can result 
  44. from working with packed files as though they were never compressed. In 
  45. particular, the same peculiarities that apply to the RAM: handler should 
  46. be expected with the XFH: ; however, at least with version 1.12 other 
  47. strange behavior can be expected as well. Second, I would like to stress 
  48. again very clearly that I as the author of XFH can in no way be held
  49. responsible for unreliable operation of the handler, nor would it be fair
  50. to see such unreliable operation as signifying that the concepts of the
  51. Xpk and of (de)-compressing file system handlers in general are in any
  52. way flawed (I for one believe these concepts to signify a new era in the
  53. area of data-compressing program interfaces). Having said this, however,
  54. it should also be said that I have myself been using the XFH: extensively
  55. for several months without problems, and that I have never (as yet) lost
  56. a single file of data due to bugs in the Xpk or XFH. And, needless to say,
  57. every effort has been made to make XFH reliable and useful.
  58.  
  59. Another thing worth pointing out is that XFH is by no means an easy
  60. program to use or even to get running at all. A thorough knowledge of
  61. the Amiga is probably essential or at least recommendable in order to
  62. use this program to its fullest. I'm working with Nicola Salmoria to
  63. make a future version of XFH require less effort to install and run. 
  64. However, due to various reasons (among which is the fact that I no
  65. longer have the equipment to continue the development of XFH or the
  66. money to spend on new equipment), I cannot say when the next XFH release
  67. will be, or indeed whether there will ever be one. Still, I would very
  68. much welcome any critisism, suggestions, bug reports, general experience
  69. etc. from users of this program. If you wish to get in touch with me
  70. you can contact me at this address:
  71.  
  72.       Kristian Nielsen
  73.       Groenjordskollegiet
  74.       room 6111
  75.       Groenjordsvej
  76.       DK-2300 Koebenhavn S
  77.       Denmark.
  78.  
  79.  
  80. Or, if you have access to e-mail, I can be reached as:
  81.  
  82.       bombadil@diku.dk
  83.  
  84.  
  85.                               --- O ---
  86.  
  87.  
  88. If you want to have a quick play-around with the XFH before reading the
  89. doc file, follow the instructions below:
  90.  
  91.  - Make sure xpkmaster.library is accessible in LIBS:, that XFH-Handler
  92. is situated in L: and that the mountlist supplied with the XFH is appended
  93. to the mountlist in DEVS: (and no, don't pack them using Xpk/XFH!).
  94.  
  95.  - If you already have a directory containing files packed with Xpk (or
  96. powerpacker), you can assign XFH0: to it. For example,
  97.  
  98.       Assign XFH0: SYS:Text/Manuals
  99.  
  100. with 'SYS:Text/Manuals' containing some packed files (perhaps in
  101. subdirectories).  This will set up the XFH unit 'XH0:'.  Alternatively,
  102. if you want to experiment with the automatic compression facility of
  103. XFH, you can copy the directory 's/xfh/' to 'S:xfh/' to set up the XFH
  104. unit 'XH1:' for compressing using the BLZW method in RAM: (you will need
  105. the library file 'libs:compressors/xpkBLZW.library').  Note that XFH
  106. needs the path "S:xfh/.xfhrc_?"; the 'xfh/' directory MUST exists in S:
  107. and contain the nessesary files in order to make XFH automatically
  108. compress files.  If you are using KS2.0 and S: is set up as a
  109. multi-assign you must also make sure that the 'xfh/' directory is placed
  110. in the FIRST of the directories that S: is assigned to (usually 'SYS:s'). 
  111.  
  112.  - Issue the CLI/Shell command
  113.  
  114.       Mount XH0:
  115. or
  116.       Mount XH1:
  117.  
  118. depending on whether you used the XFH0: assign or the S:xfh/ option files. 
  119. This will mount the handler, making it ready for use. 
  120.  
  121.  - Now access the handler in any usual way. For example:
  122.  
  123.       CD XH0:
  124.       Search fish/#?.doc "Screen hack"
  125.       Protect fish/#?.doc -w
  126.       Lharc -r a ram:mans.lzh XH0:#?
  127.  
  128. etc. for XH0:, or
  129.  
  130.       Copy SYS:System/#? XH1:
  131.       List XH1:
  132.       List RAM:
  133.       List SYS:System               ; To compare file sizes
  134.  
  135. for XH1:. You can play around with other compression methods or directories
  136. by editing the '.xfhrc_?' files in 'S:xfh/' and mounting the corresponding 
  137. XFH unit. The three supplied examples are for a BLZW compressing handler 
  138. in RAM: (unit 1), a BLZW compressing handler in SYS: (unit 2), and an 
  139. encrypting handler in RAM: (unit 3).
  140.  
  141.  
  142.  
  143.                               --- O ---
  144.  
  145.  
  146. Program history:
  147.  
  148. V1.00   Initial release.
  149. V1.00a  Bug in XObjExamine() fixed (it sometimes got the name of the root
  150.         dir wrong). Thanks to Matthias Scheler for reporting this bug.
  151. V1.00b  XFH: now obtains the values returned by ACTION_INFO and
  152.         ACTION_DISK_INFO from the underlying file system. This should
  153.         help problems with 'zero size file system' as experienced with
  154.         earlier versions of MFR for example. Thanks to Keith H. Brown
  155.         for pointing my attention to this problem.
  156. V1.10   Beta version implementing option files and automatic compression.
  157. V1.11   Xpk password support.
  158. V1.12   New XPKPRIORITY option. Also fixes bugs with bad volume names and a 
  159.         msgport that was unnessesarely public; thanks to Nicola Salmoria 
  160.         for telling me about these problem. 
  161.